home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 3.iso / dist / fw_rxvt.idb / usr / freeware / doc / rxvt / README.xvt.z / README.xvt
Text File  |  2002-04-08  |  6KB  |  172 lines
  1. -------------------------------------------------------------------------
  2. Rxvt is a heavily modified version of xvt, many modifications were made by
  3. Rob Nation <nation@rocket.sanders.lockheed.com> to make it a little more
  4. compact and to add a few simple features.
  5.  
  6. This is the README that came with xvt-2.0. It is included mainly to give
  7. the original author credit for his work.
  8.  
  9.            README file for xvt 2.0
  10.            -----------------------
  11.  
  12. Xvt is an X terminal-emulator that is designed to be more or less
  13. compatible with xterm while using much less swap space.  It is mainly
  14. intended for use at sites which use large numbers of X terminals but
  15. may also be useful on single workstations that are short of memory.  On
  16. a SPARCstation running SunOS4, an initially invoked xvt uses about 1/3
  17. megabyte of swap while xterm uses about 1.3 megabytes (obtained by
  18. running pstat rather than ps which seems to give unreliable size
  19. figures on SPARCs).  The main way that xvt achieves its small size is
  20. by avoiding the use of the X toolkit.
  21.  
  22. The current version of xvt is our default X terminal emulator and has
  23. been used for eight months by students, computing support staff and
  24. service users and so is fairly well tested.
  25.  
  26. Supported architectures
  27. -----------------------
  28.  
  29. One of the major changes between xvt-1.0 and 2.0 is that xvt-2.0 is
  30. much more portable.  The released version should build and run on all
  31. the architectures I have access to, namely: SunOS4, SunOS5, HP-UX 8.0,
  32. HP-UX 9.0, DEC OSF/1 V1.2 and ULTRIX 3.?.  In addition, the teletype
  33. initialisation code has been completely restructured to make it more
  34. portable.  Almost all the system dependent code is in the single source
  35. file, ttyinit.c.
  36.  
  37. Xterm features not supported
  38. ----------------------------
  39.  
  40.  - Tektronix 4014 emulation
  41.  
  42.  - Session logging
  43.  
  44.  - Pop-up menus.  The only one of xterm's popup menu commands that is
  45.    provided in xvt is displaying and hiding of the scrollbar and this
  46.    is done simply by pressing any mouse key in the window with the
  47.    CONTROL key held down.
  48.  
  49.  - Toolkit style configurability.  In particular, xvt does not allow
  50.    the user to remap the mouse or keyboard keys.
  51.  
  52. Major xterm features that are supported
  53. ---------------------------------------
  54.  
  55.  - VT100 emulation.  Most of the main escape sequences are supported -
  56.    certainly all those used by the standard screen based UNIX
  57.    applications.
  58.  
  59.  - Lines that scroll off the top of the window are saved can be
  60.    scrolled back with a scrollbar.
  61.  
  62.  - Text selection and insertion including double and triple click for
  63.    words and lines.
  64.  
  65. Differences between xvt2.0 and xvt1.0
  66. -------------------------------------
  67.  
  68.  - xvt2.0 is eight bit clean and will generate and display eight bit
  69.    characters.  The META key can be used to generate characters with
  70.    the eighth bit set (in eight bit mode) or prefix by escape (in seven
  71.    bit mode).
  72.  
  73.  - The teletype setup code has been rewritten to make it much more
  74.    portable.  See the comments at the head of ttyinit.c.
  75.  
  76.  - Exposure handling has been made much more efficient so that xvt should
  77.    now be useable with window managers that provide opaque window movement.
  78.  
  79.  - VT100 graphics characters are supported for fonts that include them.
  80.  
  81.  - There is now a -ls option to enable the use of a login shell.
  82.  
  83.  - Colored text cursors are now supported.
  84.  
  85.  - There is support for the -C (console window) option but only on
  86.    SunOS 4.
  87.  
  88.  - Bold characters are generated by overstriking if no bold font is
  89.    specified.
  90.  
  91.  - Function keys generate escape sequences as in xterm.
  92.  
  93.  - A number of bugs have been fixed:
  94.  
  95.    - Setting the title without a terminating ^G no longer locks up.
  96.  
  97.    - Paste followed by a keystroke will always insert in the correct
  98.      order.
  99.  
  100.    - Pasting an uninitialised string will not cause a crash.
  101.  
  102. Other differences between xvt and xterm
  103. ---------------------------------------
  104.  
  105.  - Xvt has a couple of additional enquiry escape sequences:
  106.  
  107.    ESC[7n - causes xvt to respond with the name of its X display in a
  108.         form that can be used to initialise the DISPLAY environment
  109.         variable.  If this is done in a user's .cshrc file it
  110.         provides a way to automatically update DISPLAY after an
  111.         rlogin.  Something like the following should work if the
  112.         initial ^[ in the echo command is an ESC character:
  113.  
  114.         if(!($?DISPLAY)) then
  115.         if($?term) then
  116.             if($term =~ xterm*) then
  117.             stty -echo >/dev/tty
  118.             echo -n '^[[7n' >/dev/tty
  119.             setenv DISPLAY `line </dev/tty`
  120.             stty echo >/dev/tty
  121.             endif
  122.         endif
  123.         endif
  124.  
  125.    ESC[8n - causes xvt to respond with a hex encoded copy of the server's
  126.         magic cookie which can be used to update a user's .Xauthority
  127.         file.  We have a program to do this which could be made available
  128.         if anyone is interested.
  129.  
  130. Known Bugs
  131. ----------
  132.  
  133.  - xvt does not know about transferring selections in installments and so
  134.    making large selections or trying to insert large selections will
  135.    fail.  The maximum selection size supported is server dependent but
  136.    seems to be a little under 64k on all our servers.
  137.  
  138.  - xvt does not look in all the approved places for its X resources.
  139.    It does, however, work correctly with resources that have been
  140.    loaded into the server using xrdb
  141.  
  142. Building and installing xvt
  143. ---------------------------
  144.  
  145. Xvt does not use imake but does come with a simple Makefile
  146. configuration scheme that provides some help with getting the Makefile
  147. right.  If you want to build xvt on one of the supported architectures
  148. then you should uncomment the appropriate definition at the start of
  149. the Makefile and then run `make config', which will modify other
  150. Makefile comments to bring them into line with the chosen
  151. architecture.
  152.  
  153. To install xvt, you should edit the MANDIR and BIN pathnames in the
  154. Makefile and then type 'make install' as root.  When installed for
  155. general use, xvt needs to belong to root and have the setuid flag set
  156. so that it can make entries in the /etc/utmp file.
  157.  
  158. Thanks to all the people who have mailed bug reports, patches and
  159. local improvements.  Some requested additions have gone into V2.0,
  160. others perhaps should have, but were left out due to lack of time.
  161.  
  162. Please send bug reports and WIBNIs to:
  163.  
  164. John Bovey
  165. Computing Laboratory
  166. University of Kent at Canterbury
  167. Canterbury
  168. Kent
  169. UK
  170.  
  171. email: jdb@ukc.ac.uk
  172.